<!DOCTYPE HTML>
<html>
<head>
	<meta charset="utf-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	<title>Cube Links View And Edit - Eclipse Free BIRD Tools</title>
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<meta name="description" content="Cube Links View And Edit - Eclipse Free BIRD Tools Documentation" />
	<meta name="keywords" content="Eclipse Free BIRD Tools, Documentation, Cube Links View And Edit" />
	<meta name="author" content="Eclipse Free BIRD Tools" />

	<!-- Facebook and Twitter integration -->
	<meta property="og:title" content="Cube Links View And Edit - Eclipse Free BIRD Tools"/>
	<meta property="og:image" content=""/>
	<meta property="og:url" content=""/>
	<meta property="og:site_name" content="Eclipse Free BIRD Tools"/>
	<meta property="og:description" content="Cube Links View And Edit documentation for Eclipse Free BIRD Tools"/>
	<meta name="twitter:title" content="Cube Links View And Edit - Eclipse Free BIRD Tools" />
	<meta name="twitter:image" content="" />
	<meta name="twitter:url" content="" />
	<meta name="twitter:card" content="" />

	<link href="https://fonts.googleapis.com/css?family=Raleway:100,300,400,700" rel="stylesheet">

	<!-- Animate.css -->
	<link rel="stylesheet" href="../css/animate.css">
	<!-- Icomoon Icon Fonts-->
	<link rel="stylesheet" href="../css/icomoon.css">
	<!-- Themify Icons-->
	<link rel="stylesheet" href="../css/themify-icons.css">
	<!-- Bootstrap  -->
	<link rel="stylesheet" href="../css/bootstrap.css">
	<!-- Magnific Popup -->
	<link rel="stylesheet" href="../css/magnific-popup.css">
	<!-- Owl Carousel  -->
	<link rel="stylesheet" href="../css/owl.carousel.min.css">
	<link rel="stylesheet" href="../css/owl.theme.default.min.css">
	<!-- Theme style  -->
	<link rel="stylesheet" href="../css/style.css">

	<!-- Modernizr JS -->
	<script src="../js/modernizr-2.6.2.min.js"></script>
	<!-- Page Allowlist Check -->
	<script src="../js/allowlist.js"></script>
	<!-- FOR IE9 below -->
	<!--[if lt IE 9]>
	<script src="../js/respond.min.js"></script>
	<![endif]-->

	<style>
		/* Clean, modern documentation styles */
		.doc-content {
			padding: 60px 0;
			min-height: 600px;
			background: white;
		}

		.content-wrapper {
			max-width: 900px;
			margin: 0 auto;
			padding: 0 40px;
		}

		/* Typography */
		.doc-content h1 {
			color: #192a45;
			font-size: 2.5rem;
			font-weight: 700;
			border-bottom: 3px solid #17B794;
			padding-bottom: 15px;
			margin-bottom: 35px;
		}

		.doc-content h2 {
			color: #2c3e50;
			font-size: 1.8rem;
			font-weight: 600;
			margin-top: 45px;
			margin-bottom: 25px;
			padding-top: 20px;
		}

		.doc-content h3 {
			color: #34495e;
			font-size: 1.4rem;
			font-weight: 600;
			margin-top: 35px;
			margin-bottom: 20px;
		}

		.doc-content p {
			font-size: 16px;
			line-height: 1.8;
			color: #4a5568;
			margin: 20px 0;
		}

		/* Code blocks */
		.doc-content pre {
			background: #f7fafc;
			border: 1px solid #e2e8f0;
			border-left: 4px solid #17B794;
			padding: 20px;
			border-radius: 8px;
			overflow-x: auto;
			margin: 25px 0;
			font-size: 14px;
		}

		.doc-content code {
			background: #f7fafc;
			padding: 3px 6px;
			border-radius: 4px;
			font-family: 'Monaco', 'Courier New', monospace;
			font-size: 0.9em;
			color: #e53e3e;
		}

		.doc-content pre code {
			background: transparent;
			padding: 0;
			color: #2d3748;
		}

		/* Blockquotes */
		.doc-content blockquote {
			background: #f0fdf4;
			border-left: 4px solid #17B794;
			margin: 25px 0;
			padding: 20px 25px;
			color: #2d3748;
			font-style: italic;
			border-radius: 0 8px 8px 0;
		}

		/* Lists */
		.doc-content ul, .doc-content ol {
			margin: 20px 0;
			padding-left: 35px;
			color: #4a5568;
		}

		.doc-content li {
			margin: 10px 0;
			line-height: 1.7;
		}

		/* Images */
		.doc-content img {
			margin: 30px auto;
			display: block;
		}

		.doc-content .guide-image {
			max-width: 100%;
			height: auto;
			border: 2px solid #e2e8f0;
			border-radius: 12px;
			box-shadow: 0 4px 12px rgba(0,0,0,0.08);
			margin: 35px auto;
			display: block;
			transition: all 0.3s ease;
		}

		.doc-content .guide-image:hover {
			transform: translateY(-2px);
			box-shadow: 0 8px 24px rgba(0,0,0,0.12);
			border-color: #008793;
		}

		/* Links */
		.doc-content a {
			color: #17B794;
			text-decoration: none;
			font-weight: 500;
			transition: all 0.2s ease;
			border-bottom: 1px solid transparent;
		}

		.doc-content a:hover {
			color: #0e7c61;
			border-bottom-color: #17B794;
		}

		/* Tables */
		.doc-content table {
			width: 100%;
			margin: 30px 0;
			border-collapse: collapse;
			border: 1px solid #e2e8f0;
			border-radius: 8px;
			overflow: hidden;
		}

		.doc-content table th {
			background: #f7fafc;
			padding: 12px 15px;
			text-align: left;
			font-weight: 600;
			color: #2d3748;
			border-bottom: 2px solid #e2e8f0;
		}

		.doc-content table td {
			padding: 12px 15px;
			border-bottom: 1px solid #e2e8f0;
		}

		.doc-content table tr:last-child td {
			border-bottom: none;
		}

		/* Horizontal rule */
		.doc-content hr {
			border: none;
			height: 2px;
			background: linear-gradient(to right, transparent, #e2e8f0, transparent);
			margin: 50px 0;
		}

		/* Responsive adjustments */
		@media (max-width: 768px) {
			.content-wrapper {
				padding: 0 20px;
			}

			.doc-content h1 {
				font-size: 2rem;
			}

			.doc-content h2 {
				font-size: 1.5rem;
			}

			.doc-content h3 {
				font-size: 1.2rem;
			}
		}
	</style>
</head>
<body>

<div class="gtco-loader"></div>

<div id="page">

	<!-- Navigation Include -->
	<div w3-include-html="../navbar.html"></div>

	<header class="hero-section">
		<div class="gtco-container">
			<div class="row">
				<div class="col-md-12 text-center">
					<h1>Cube Links View And Edit</h1>
					<h2>Eclipse Free BIRD Tools Documentation</h2>
				</div>
			</div>
		</div>
	</header>

	<!-- Dynamic Sidebar will be inserted here by JavaScript -->

	<!-- Main Content -->
	<section class="main doc-content ">
  		<div class="content-wrapper">
 			<h2 id="feature-overview">Feature Overview</h2>
<p>The Cube Links View and Edit interface is a sophisticated visualization and management tool within Eclipse Free BIRD Tools that enables users to create, manage, and visualize relationships between data cubes and their components. This feature provides both tabular and graphical representations of data linking, showing how information moves from source cubes through transformations to target cubes in regulatory reporting frameworks.</p>
<h2 id="purpose">Purpose</h2>
<p>Cube Links View and Edit addresses the complexity of modern regulatory data relationships by providing:</p>
<ul>
<li><strong>Visual Data Lineage</strong>: Understand how data flows from input to output layer</li>
<li><strong>Relationship Management</strong>: Create and maintain connections between data cubes</li>
<li><strong>Network Visualization</strong>: See complex relationships through interactive diagrams</li>
<li><strong>Quality Assurance</strong>: Validate data transformation paths before production</li>
</ul>

<p>This feature is essential for data architects, compliance officers, and IT professionals who need to maintain transparent, auditable data flows in regulatory reporting environments.</p>
<h2 id="getting-started">Getting Started</h2>
<h3 id="prerequisites">Prerequisites</h3>
<p>Before using Cube Links View and Edit, ensure:</p>
<ul>
<li>Data cubes are properly configured in the system (through the launch of the first step in the workflow dashboard)</li>
<li>Source and target cubes contain valid data structures and the linkage has been generated (by step 2 in the workflow dashboard)</li>
</ul>

<h3 id="accessing-the-interface">Accessing the Interface</h3>
<p>Navigate to the FreeBIRD Application and access the Cube Links feature from the main dashboard. The interface provides both tabular views for detailed management and network graphs for visual understanding.</p>
<p><img src="../images/screenshots/cube_links_view/CubeLinksView_Screenshot__4.38.32PM.png" alt="Cube Links View Main Interface" class="img-responsive guide-image"></p>
<h2 id="step-by-step-guide">Step-by-Step Guide</h2>
<h3 id="understanding-the-interface">Understanding the Interface</h3>
<h4 id="main-control-panel">Main Control Panel</h4>
<p>The interface is organized into several key areas:</p>
<p><strong>Selection Filters:</strong></p>
<ul>
<li><strong>Foreign Cube Selector</strong>: Choose the source cube for viewing/editing links (e.g., <code>F_05_01_REF_FINREP_3_0</code>)</li>
<li><strong>Product Identifier Selector</strong>: Filter cube links by product type (e.g., <code>Other loans</code>)</li>
</ul>

<p><strong>Action Buttons:</strong></p>
<ul>
<li><strong>Apply Filters</strong> (Blue): Apply selected criteria to the data grid</li>
<li><strong>Reset Filters</strong> (Gray): Clear all filters and return to default view</li>
<li><strong>Add New Cube Link</strong> (Green): Create new cube link relationships</li>
<li><strong>View Network Graph</strong> (Blue): Display graphical representation</li>
<li><strong>Export Diagram</strong> (Purple): Export network diagrams</li>
</ul>

<h4 id="data-grid-structure">Data Grid Structure</h4>
<p>The main grid displays cube link information with these columns:</p>
<ol>
<li><strong>Maintenance Agency</strong>: Entity responsible for maintaining the link</li>
<li><strong>Cube Link ID</strong>: Unique identifier (format: <code>ForeignCube::TargetItem</code>)</li>
<li><strong>Code</strong>: Classification code</li>
<li><strong>Name</strong>: Descriptive name (format: <code>INSTRUMENT:Description:TARGET</code>)</li>
</ol>

<h3 id="creating-new-cube-links">Creating New Cube Links</h3>
<p><strong>Step 1: Initiate Creation</strong></p>
<ul>
<li>Click the <strong>Add New Cube Link</strong> button</li>
<li>A dialog window opens for configuration</li>
</ul>

<p><strong>Step 2: Configure the Link</strong></p>
<ul>
<li>Select source cube from dropdown menu</li>
<li>Choose source cube to connect</li>
<li>Define target cube for mapping</li>
</ul>

<p><strong>Step 3: Save and Validate</strong></p>
<ul>
<li>Click <strong>Save</strong> to create the link</li>
<li>The new link appears in the data grid</li>
<li>Verify the connection through the network graph</li>
</ul>

<h3 id="using-network-graph-visualization">Using Network Graph Visualization</h3>
<p><img src="../images/screenshots/cube_links_view/CubeLinksView_Screenshot__4.38.39PM.png" alt="Network Graph Visualization" class="img-responsive guide-image"></p>
<p><strong>Understanding Visual Elements:</strong></p>
<ul>
<li><strong>Source Cube</strong> (Orange cylinder): Originating data cube</li>
<li><strong>Source Items</strong> (Blue rectangle): Individual data elements</li>
<li><strong>Target Items</strong> (Green diamond): Transformation points</li>
<li><strong>Target Cube</strong> (Yellow cylinder): Destination cube</li>
<li><strong>Arrows</strong>: Data flow direction</li>
</ul>

<p><strong>Navigation Controls:</strong></p>
<ul>
<li><strong>Scroll</strong>: Use mouse wheel or zoom controls</li>
<li><strong>Close</strong>: Red button to exit visualization</li>
</ul>

<h3 id="filtering-and-searching">Filtering and Searching</h3>
<p><strong>Apply Filters:</strong></p>
<ol>
<li>Select desired Foreign Cube from dropdown</li>
<li>Choose Product Identifier if needed</li>
<li>Click <strong>Apply Filters</strong> to update the view</li>
<li>Use <strong>Reset Filters</strong> to clear selections</li>
</ol>

<p><strong>View Filtered Results:</strong></p>
<ul>
<li>The data grid updates to show only defined matching links</li>
<li>Network graph reflects the links to the selected output layer cube.</li>
</ul>

<h3 id="exporting-diagrams">Exporting Diagrams</h3>
<p><strong>Export Process:</strong></p>
<ol>
<li>Open the network graph view</li>
<li>Click <strong>Export Diagram</strong> button (as Markdown)</li>
</ol>

<h3 id="common-issues-and-solutions">Common Issues and Solutions</h3>
<p><strong>Missing Cube Links:</strong></p>
<ul>
<li>Verify current filter settings are not too restrictive</li>
<li>Confirm the source cubes exist and are accessible</li>
<li>Add cube links if needed for your usecase (or defined join_configurations to get the cube links dependent on your type of instrument).</li>
</ul>

<p><strong>Link Creation Failures (running step 2):</strong></p>
<ul>
<li>Verify both source and target cubes exist in the system</li>
</ul>

<h3 id="system-validation">System Validation</h3>
<p>The system automatically performs:</p>
<ul>
<li>Circular reference detection and prevention</li>
<li>Duplicate link identification (Through the show duplicate member links view)</li>
<li>Required field validation</li>
<li>Data type compatibility checks</li>
</ul>

<h2 id="conclusion">Conclusion</h2>
<p>The Cube Links View and Edit feature provides essential capabilities for managing complex data relationships in regulatory environments. Through its combination of detailed tabular views and intuitive network visualizations, it enables both technical and business users to understand, create, and maintain the data lineage critical for accurate regulatory reporting.</p>
<h3 id="next-steps">Next Steps</h3>
<ul>
<li>Explore the <a href="workflow-dashboard-guide.html">Workflow Dashboard Guide</a> to understand how cube links integrate with workflows</li>
<li>Review the <a href="member-hierarchy-editor.html">Member Hierarchy Editor</a> for related data structure management</li>
<li>Learn about <a href="mapping-editor.html">Mapping Editor</a> for detailed transformation rules</li>
</ul>

<p>For assistance with cube link design or complex relationship modeling, connect with the community via <a href="https://chat.eclipse.org/#/room/%23technology.efbt:matrix.eclipse.org">Eclipse Chat</a> or email <a href="mailto:efbt-dev@eclipse.org">efbt-dev@eclipse.org</a>.</p>
  		</div>
	</section>

	<!-- Footer Include -->
	<div w3-include-html="../footer.html"></div>

</div>

<!-- jQuery -->
<script src="../js/jquery.min.js"></script>
<!-- jQuery Easing -->
<script src="../js/jquery.easing.1.3.js"></script>
<!-- Bootstrap -->
<script src="../js/bootstrap.min.js"></script>
<!-- Waypoints -->
<script src="../js/jquery.waypoints.min.js"></script>
<!-- Carousel -->
<script src="../js/owl.carousel.min.js"></script>
<!-- Magnific Popup -->
<script src="../js/jquery.magnific-popup.min.js"></script>
<script src="../js/magnific-popup-options.js"></script>
<!-- Main -->
<script src="../js/main.js"></script>
<!-- W3 Include -->
<script src="../js/w3-include.js"></script>
<!-- Dynamic Sidebar -->
<script src="../js/dynamic-sidebar.js"></script>

</body>
</html>